home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1996 May: Tool Chest / Developer CD Series May 1996 (Tool Chest) (Apple Computer) (1996).iso / Tool Chest / Files / UnmountIt 1.2 / UnmountIt Read Me < prev    next >
Encoding:
Text File  |  1995-06-20  |  7.1 KB  |  78 lines  |  [ttro/ttxt]

  1. UnmountIt
  2. version 1.2
  3. Copyright © 1992-1995, Apple Computer, Inc.
  4. All Rights Reserved
  5. by Jim Luther, Apple Developer Technical Support
  6.  
  7. UnmountIt is free software and can be distributed freely by individuals. For commercial distribution or bulletin board distribution please contact Apple Software Licensing at AppleLink: SW.LICENSE
  8.  
  9. UnmountIt is distributed “as is” and unsupported by Apple or the author. Please don’t call Apple or the author for technical support on this program.
  10.  
  11. Who needs it?
  12.  
  13. If you have System 7.5 Update 1.0 installed, then you probably don’t need UnmountIt. Macintosh File Sharing version 7.6.1 (part of System 7.5 Update 1.0) allows shared volumes to be unmounted if they haven’t been mounted by remote File Sharing clients. Macintosh File Sharing version 7.6.1 also attempts to share newly mounted volumes - File Sharing no longer needs to be restarted to share new volumes.
  14.  
  15. Only users of Macintosh System Software 7.0 through 7.5 will find UnmountIt useful.
  16.  
  17. What's it do?
  18.  
  19. UnmountIt lets you easily unmount and eject sharable volumes when Macintosh File Sharing is in use. You can can use UnmountIt a couple of ways:
  20.  
  21. • You can simply leave it on your desktop or in an open folder. Whenever you want to unmount a sharable volume, just drag the volume icons to UnmountIt instead of the Finder’s Trash icon. UnmountIt will launch, unmount and eject the volumes, and then UnmountIt will quit.
  22.  
  23. • You can launch UnmountIt and leave it running. Whenever you want to unmount a sharable volume, either drag the volume icons to UnmountIt instead of the Finder’s Trash icon or select “Unmount Volume…” from UnmountIt’s File menu. UnmountIt will unmount the volumes and leave itself running.
  24.  
  25. Any mounted volume can be unmounted with UnmountIt and UnmountIt always attempts to do the right thing. Unmount will:
  26.  
  27. •  turn off Macintosh File Sharing (if needed), unmount and eject the volume, and then turn Macintosh File Sharing back on (if it was on to begin with).
  28.  
  29. • warn you before turning off Macintosh File Sharing if any remote users are using the File Sharing file server.
  30.  
  31. • empty trash on AppleShare volumes before unmounting them.
  32.  
  33. • warn you before unmounting local non-ejectable volumes.
  34.  
  35. • not let you unmount the boot volume.
  36.  
  37. • not let you unmount a volume that has open files on it.
  38.  
  39. Version 1.1 and later of UnmountIt adds the Restart File Sharing feature. Restart File Sharing simply turns off Macintosh File Sharing and then turns it back on. This is useful if you have just mounted a CD-ROM or ejectable hard disk cartridge and want File Sharing to share it. You can use the Restart File Sharing a couple of ways:
  40.  
  41. • You can launch UnmountIt and hold down the Control key. UnmountIt will launch, restart Macintosh File Sharing, and then quit automatically.
  42.  
  43. • If UnmountIt is already running, you can select Restart File Sharing from UnmountIt’s File menu. UnmountIt will restart Macintosh File Sharing and leave itself running.
  44.  
  45. The Restart File Sharing feature is only available when Macintosh File Sharing is already running. If File Sharing is off or not installed, the feature is disabled. Since the AppleShare 3.0 file server can prepare volumes for sharing anytime (even while the server is running), Restart File Sharing is always disabled with the AppleShare 3.0 file server.
  46.  
  47. Technical Background
  48.  
  49. Important Note: This information only pertains to the versions of Macintosh File Sharing that ship with System 7.0 through 7.5. Macintosh File Sharing version 7.6.1 (part of System 7.5 Update 1.0), which is based on the AppleShare 4.0 file server, no longer uses the methods described in this section.
  50.  
  51. When Macintosh File Sharing is turned on, it builds a list of sharable volumes by first enumerating the entire list of volumes with the Macintosh File Manager’s PBHGetVInfo function and checking the volume’s attributes with the PBHGetVolParms function. Each volume found is then checked for specific attributes which make it unsharable. The reasons a volume might be unsharable are:
  52.  
  53. • the volume is owned by the .Sony driver—that is, the volume is a 3.5” floppy disk.
  54.  
  55. • the volume is a remote AppleShare volume.
  56.  
  57. • the volume is not an HFS volume.
  58.  
  59. • the volume cannot be prepared for use by Macintosh File Sharing. Macintosh File Sharing attempts to create, or verify if already created, the parallel directory structure (PDS) file which will be either in that volume’s root directory or in the boot volume’s “System Folder:Preference” folder if the volume is read-only (for example, in the case of a CD-ROM or locked removable disk cartridge). If the PDS file cannot be created, the volume is not sharable.
  60.  
  61. The first 10 volumes Macintosh File Sharing finds that are sharable are then shared for use by the Macintosh’s owner remotely, even if they haven’t been made share points. That brings up the following question: What’s the difference between a sharable volume and a share point?
  62.  
  63. • A sharable volume is a volume that the Macintosh server owner can access remotely whenever Macintosh File Sharing is on. When looking at the file server from the Chooser, the server owner can see and mount any sharable volume. The server owner can always access the entire mounted sharable volume remotely.
  64.  
  65. • A share point is the root folder (it might or might not be the root directory of a volume) of an area the Macintosh server owner has made accessible to other users by checking the “Share this item and its contents” box in the Finder’s Sharing dialog.  Macintosh File Sharing supports up to 10 share points per server.  Those 10 share points can be placed on any sharable volume.  All users except for the server owner see share points when they look at the file server from the Chooser.
  66.  
  67. When File Sharing is on, Macintosh File Sharing imposes a couple of restrictions on sharable volumes.  The volume names and share point folder names are locked, and the sharable volumes cannot be unmounted (even if no remote user has them mounted).  This is done because Macintosh File Sharing does not let the list of volumes change while a remote Macintosh has a shared volume mounted or while a remote Macintosh is looking at the list of volumes with the Chooser.  If you try to unmount a sharable volume by dragging it to the Trash while Macintosh File Sharing is on, you’ll get the following message from the Finder: “The volume “VolumeName” could not be put away, because it is being shared.”
  68.  
  69. The only way you can unmount a sharable volume is to turn Macintosh File Sharing off, unmount (and possible eject) the volume, and then turn Macintosh File Sharing back on.  UnmountIt automates that task.
  70.  
  71. Note: One of these restrictions was removed by additional code present in the AppleShare 3.0 file server; a volume can be unmounted at any time with AppleShare 3.0, but all remote users who have that volume mounted must be disconnected before the volume can be unmounted.
  72.  
  73. Release Notes
  74.  
  75. 1.1 - Added the Restart File Sharing operation and gave UnmountIt the cool color icons supplied by Brigham Stevens.
  76.  
  77. 1.2 - Added check for Macintosh File Sharing 7.6.1. If version of Macintosh File Sharing is 7.6.1, then UnmountIt does not shut off File Sharing to unmount a shared volume.
  78.